John Doe

Using Siteleaf CMS with devlopr-jekyll Blog

2019-05-22T09:05:23+00:00

Hey There, Today we will see on how to unlock the superpowers of our devlopr-jekyll blog. We will be using Siteleaf CMS to modify content of our blog.

Note : If you have not created your blog yet. Create Your Blog , then comeback later

Select Connect with Github, connect existing repository:

Select the repository of your devlopr-jekyll blog:

Connect and Create Site:

After successful import, You will be redirected to manage dashboard :

But before making any changes to our blog, we need to change our current Siteleaf membership plan to Free Plan (For Developers)

Select Free Plan :

Congrats ! Your New Admin Panel for your devlopr-jekyll blog is ready to make any changes to your blog :D

How to deploy devlopr-jekyll Blog using Github Pages and Travis

2019-05-21T09:05:23+00:00

This guide assumes that you already have created your blog and tested locally. If not please follow this tutorial : Create a Blog using devlopr jekyll. Then come back and proceed with the deployment process.

In this Guide, we are using Github Pages and Travis CI for deploying our blog. Sometimes Github Pages does not support external third party plugins. In that case we deploy our blog using Travis CI, it automatically builds our website and pushes the static files of the site to a deployment branch. Which then Github Pages uses to render the site. Hope you get it :P !

We might need to instruct Travis CI to follow deployment instructions. Copy the below content in .travis.yml file:

language: ruby
cache: bundler

# Travis will build the site from gh-pages branch 
# and deploy the content to master branch 
# use gh-pages branch to serve for github pages
# master branch will be used for deployment

branches:
  only:
  - gh-pages
script: 
  - JEKYLL_ENV=production bundle exec jekyll build --destination site

# You need to generate a Personal Access Token 
# https://github.com/settings/tokens
# Add this token in environment variable GITHUB_TOKEN in Travis CI repo settings

deploy:
  provider: pages
  local-dir: ./site
  target-branch: master
  email: deploy@travis-ci.org
  name: Deployment Bot
  skip-cleanup: true
  github-token: $GITHUB_TOKEN
  keep-history: true
  on:
    branch: gh-pages

# Generate your secure token with the travis gem:
# get Github token from your Travis CI profile page
  gem install travis
  travis encrypt 'GIT_NAME="YOUR_USERNAME" GIT_EMAIL="YOUR_EMAIL" GH_TOKEN=YOUR_TOKEN' --add env.global --com

# env:
#   global:
#     secure: Example

All we are doing is telling Travis to pick up files from our gh-pages branch and push the build files to master branch.

Generate a New Github Personal Access Token

We need this token as a Environment Variable in Travis. For Travis can automatically login as you, and finish its job of building your site and pushing it to your repo’s master branch.

Go to Github Generate a New Token Page.

Create a new Access Token

Configure Travis

Go to Travis and Toggle the repository access to use Travis

Go to the repository settings page and Add Environment Variable ‘GITHUB_TOKEN’

Push your changes to Github

Commit your local changes in gh-pages branch

git add . git commit -m "added new post" git push origin gh-pages

After push, Travis will automatically run a build process and deploy your blog.

You can visit your site at https://yourusername.github.io

Done ! Enjoy your brand new devlopr-jekyll blog. You can visit the site at https://yourusername.github.io

Build and Deploy a blog using devlopr-jekyll and Github Pages

2019-05-20T09:05:23+00:00

If you are a developer, who want a fast static website with no cost for hosting/domain stuff. This guide will help you setup a blog for you for free using devlopr-jekyll theme

Before Proceeding Lets Setup Our Development Environment :

Step 1 - Setting up Development Environment

We need ruby and Bundler to build our site locally. You can check out this Guide to install the same for your OS.

Install Ruby

ruby -v
ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux-gnu]

Install Bundler

gem install bundler

After installation check if its working:

bundler -v
Bundler version 2.0.1

Step 2 - Create a new repo for your blog in Github using devlopr starter

Go to devlopr starter. Click on the “Green” - Use this Template Button.

Create a new repo with name as “yourusername.github.io” replacing yourusername with your github username.

Note : You can use any other name like “my-blog” but then , if you are using github pages for deployment. your site will be built at the subdomain - yourusername.github.io/my-blog.

Step 3 - Clone your repo locally

You will get the clone url from here:

git clone https://github.com/yourusername/yourusername.github.io.git

Step 3 - Make all your changes Locally

Make all your changes locally

$ cd yourusernme.github.io $ code .

Open the files using VSCode and edit _config.yml and edit with your details:

_config.yml file - replace with your own details
_posts - Add your blog posts here
_includes - You can replace the contents of the files with your data. (contains widgets)
_assets/img - Add all your images here

Step 4 - Install the dependencies

$ bundle update $ bundle install

Step 5 - Serve the site locally (development mode)

bundle exec jekyll serve

You can visit the site at http://localhost:4000

After you think its fine, proceed with the next step !

Step 6 - Publish Your Changes

After you are happy with your blog. It’s time to show it to the world. There are several ways which are possible for deploying the blog for free. Below is the list of build guides :

Move to your Blog Directory and commit your Changes Locally

$ cd yourusername.github.io $ git add . $ git commit -m "made changes to my blog"

Push your changes to Github

$ git push origin master

Step 7 - Congrats - Your Site is Live

You can visit your blog at http://yourusername.github.io